The open-source reactive database for app developers

npm create convex

Everything is code

From database schemas to queries, from auth to APIs, express every part of your backend in pure TypeScript. Your backend code lives next to your app code, is typechecked and autocompleted, and is generated by AI with exceptional accuracy.

Screenshot of app preview and Convex dashboard

Always in sync

Convex libraries guarantee that your app always reflects changes to your frontend code, backend code, and database state in real time. No need for state managers, cache invalidation policies, or websockets.

Backend built-ins

Create cron jobs, kick off backend AI workflows, leverage built-in auth, and tap into a growing ecosystem of components that solve common backend needs with just an npm i.

The open-source reactive database for app developers

Start building

npm create convex

import { mutation, query }

from "./_generated/server";

import { v } from "convex/values";

export const setComplete = mutation({

args: { id: v.id("todos") },

handler: async (ctx, args) => {

await ctx.db.patch(args.id, {

// Try checking a todo--nothing happens!

// Change this to `true` and try again.

completed: false,

});

export const list = query({…});

export const add = mutation({…});

export const setIncomplete = mutation({

args: { …) },

handler: async (ctx, args) => {

await ctx.db.patch(args.id, { completed: false });

});

Try it out!

import { defineSchema, defineTable } from "convex/server";

import { v } from "convex/values";

export default defineSchema({

todos: defineTable({

text: v.string(),

category: v.optional(v.string()),

completed: v.boolean(),

}).index("by_completed", ["completed"]),

});

import { api } from "../../convex/_generated/api";

import { TodoList } from "./TodoList";

import { useQuery } from "convex/react";

export function TodoApp() {

// Load more by changing `count` to 10.

// Everything updates reactively.

const todos = useQuery(api.todos.list, { count: 5 });

return <TodoList todos={todos} />;

}

Try it out!

import { mutation, query } from "./_generated/server";

import { v } from "convex/values";

export const setComplete = mutation({…});

export const list = query({

args: { count: v.number() },

handler: async (ctx, args) => {

return await ctx.db.query("todos").order("desc").take(args.count);

});

export const add = mutation({…});

export const setIncomplete = mutation({…});

import { cronJobs } from "convex/server";

import { internal } from "./_generated/api";

const crons = cronJobs();

crons.interval(

"categorize todos",

{ seconds: 5 },

internal.categorize.categorize,

{

// Add categories "Sports" and "Health"

// to see the todos categorized on the

// next cron job run.

categories: ["Chores", "Work"],

);

export default crons;

Try it out!

import { v } from "convex/values";

import { api, internal } from "./_generated/api";

import { Doc, Id } from "./_generated/dataModel";

import { internalAction, internalMutation } from "./_generated/server";

import Anthropic from "@anthropic-ai/sdk";

type AiCategorizeResponse = {

id: Id<"todos">;

category: string;

};

export const categorize = internalAction({

args: { categories: v.array(v.string()) },

handler: async (ctx, args) => {

const todos = await ctx.runQuery(api.todos.list, { count: 100 });

const response = await categorizeTodos(todos, args.categories);

await ctx.runMutation(internal.categorize.setCategories, {

categories: response,

});

export const setCategories = internalMutation({

args: {

categories: v.array(v.object({ id: v.id("todos"), category: v.string() })),

handler: async (ctx, args) => {

for (const category of args.categories) {

await ctx.db.patch(category.id, {

category: category.category,

});

}

});

async function categorizeTodos(

todos: Doc<"todos">[],

categories: string[],

): Promise<AiCategorizeResponse[]> {

const claude = new Anthropic({

apiKey: process.env.ANTHROPIC_API_KEY!,

});

const prompt = `

` The categories are: ${categories.join(", ")}.

. The todoId and todo text are:

. The todoId and todo text are: ${todos.map((todo) => `${todo._id}: ${todo.text}`).join("\n")}.

. Return a JSON object with the format: {"todos": [{"id": "$todoId", "category": "$category"}]},

. Return a JSON object with the format: {"todos": [{"id": "$todoId", "category": "$category"}]}, where $todoId is the id of the todo and $category is the task category that the todo most closely matches.

const message = await claude.messages.create({

model: "claude-3-sonnet-20240229",

max_tokens: 1000,

system:

"You are a helpful assistant that categorizes human-written todo items into categories.",

messages: [

{

role: "user",

content: prompt,

});

// Get the first text content block

const content = message.content.find((block) => block.type === "text");

if (!content || content.type !== "text") {

throw new Error("Unexpected response format from Claude");

}

return JSON.parse(content.text);

}

import { defineSchema, defineTable } from "convex/server";

import { v } from "convex/values";

export default defineSchema({

todos: defineTable({

text: v.string(),

category: v.optional(v.string()),

completed: v.boolean(),

}).index("by_completed", ["completed"]),

});

AI Tools

LLMs love Convex

With Convex, everything is just TypeScript. This means your favorite AI tools are pre-equipped to generate high quality code.

Learn more

Try Convex with

Product

Not just a database

Everything your product deserves to build, launch, and scale.

Learn more Illustration of the features provided by Convex, including realtime updates, type safety, and automatic caching.

Customer Love

Loved by developers

What people building their business on Convex are saying.

Next + Convex (all in typescript) Vs Angular (typescript) + Django (python) + Postgres + S3 + Websocket DIY + SQS + IaC + DIY e2e type safety 🤔

WebDevCody@webdevcody

@convex_dev Simple. Fast. Realtime.

AndyOz@andy_austin_dev

I think @convex_dev might be the best DB I've ever used

Robin@robinxpfp

Happy to see more first-class clerk x convex integration There's such a major architecture shift around Serverless + Edge + React + Typescript that (imo) it's unlikely sql is still the right abstraction Very compelling that convex is approaching this from first principles

Colin | Clerk.com@tweetsbycolin

😱 @convex_dev is the gift that keeps on giving Check it out in combination with @nextjs docs.convex.dev

Guillermo Rauch@rauchg

@convex_dev is everything I wanted Firebase to be. Such a great tool. Feels illegal to know about this before others.

Timothy Stepro@tim_stepro

#dailytip if you are a #react developer and want an alternative to Firebase, you might want to give @convex_dev a try. It has amazing ReactHooks with samples in #Javascript and #typescript and the price isn't bad. I'm not a Firebase expert but it looks like all features are there

urubatan@urubatan

@convex_dev feels like what I wanted Firebase and MongoDB Realm to be and more. Really enjoying the DX so far!

David Kim@dvddkkim

I used @convex_dev once to make sure our integration at @ClerkDev worked and the docs matched what we expected. It's magical. I don't say that lightly. I think it's time to do a video on the channel.

James Perkins@james_r_perkins

I'm working on a new app build with @convex_dev and I am *very* excited about the tech here - DB schema defined in TS - end-to-end types (like if tRPC also set up your DB) - real-time updates Just Work™

Jason Lengstorf@jlengstorf

Managing an application's state has become easier, but the global state concept is still a pain for developers, which @convex_dev aims to solve. I made a realtime application using @convex_dev, @nextjs, and @auth0 and loved it.😍

Anshuman Bhardwaj@sun_anshuman

Interesting tool of the week: convex.dev by @convex_dev We like: Makes it easy to build a live-updating web app with a document database. Strictly-typed fully relational schemas defined in code (optional, but recommended)

Console - Devtools, devtools, devtools@consoledotdev

urubatan@urubatan

I used @convex_dev once to make sure our integration at @ClerkDev worked and the docs matched what we expected. It's magical. I don't say that lightly. I think it's time to do a video on the channel.

James Perkins@james_r_perkins

@convex_dev feels like what I wanted Firebase and MongoDB Realm to be and more. Really enjoying the DX so far!

David Kim@dvddkkim

😱 @convex_dev is the gift that keeps on giving Check it out in combination with @nextjs docs.convex.dev

Guillermo Rauch@rauchg

urubatan@urubatan

I used @convex_dev once to make sure our integration at @ClerkDev worked and the docs matched what we expected. It's magical. I don't say that lightly. I think it's time to do a video on the channel.

James Perkins@james_r_perkins

@convex_dev feels like what I wanted Firebase and MongoDB Realm to be and more. Really enjoying the DX so far!

David Kim@dvddkkim

😱 @convex_dev is the gift that keeps on giving Check it out in combination with @nextjs docs.convex.dev

Guillermo Rauch@rauchg

Colin | Clerk.com@tweetsbycolin

Jason Lengstorf@jlengstorf

@convex_dev is everything I wanted Firebase to be. Such a great tool. Feels illegal to know about this before others.

Timothy Stepro@tim_stepro

I think @convex_dev might be the best DB I've ever used

Robin@robinxpfp

Colin | Clerk.com@tweetsbycolin